18. Audio Commands > 18.14 AT^SNFO   Set audio output (= loudspeaker path) parameter

18.14
AT^SNFO   Set audio output (= loudspeaker path) parameter
AT^SNFO controls the earpiece path amplification. The read and write commands refer to the active audio mode. The write command works only in audio modes 2 to 6.
Syntax
Test Command  
Response(s)
^SNFO: (list of supported <outBbcGain>s), (list of supported <outCalibrate>s), (list of supported <outStep>s), (list of supported <sideTone>s)
Read Command  
Response(s)
Write Command  
Response(s)
Reference(s) 
PIN 
ASC0 
ASC1 
USB 
MUX1 
MUX2 
MUX3 
Charge 
Last 

Parameter Description
 
<outBbcGain>(num)(^SNFW)
Negative DAC gain (attenuation) adjustable in four 6 dB steps from 0 dB to -18 dB (0=0 dB, 3=-18 dB)
0...3
 
 
<outCalibrate>(num)(^SNFW)
Formula to calculate the value of the 5 volume steps selectable with parameter <outStep>:
Attenuation = 20 * log (2 * outCalibrate[n] / 32768)
0...32767
 
 
Volume steps 0 - 4, each defined with outCalibrate[n]
0...[4]
 
 
<sideTone>(num)(^SNFW)
Multiplication factor for the sidetone gain.
Formula to calculate how much of the original microphone signal is added to the earpiece signal:
Sidetone gain in dB = 20 * log (sideTone / 32768).
0...32767
 


Notes
•
<outCalibrate> specifies the amount of volume of each <outStep>. The range of each <outCali­brate> is up to 65535, but will be suppressed to 32767. A value above <outCalibrate>= 65535 will cause an error.
•
The range of <sideTone> is up to 65535, but will be suppressed to 32767. A value above <sideTone>= 65535 will cause an error.
•
Any change to <outStep> takes effect in audio modes 2 to 6. That is, when you change <outStep> and then select another mode with AT^SNFS, the same step will be applied. Nevertheless, the sound quality and the amount of volume are not necessarily the same, since all remaining audio parameters can use different values in either mode.
•
Audio mode 1 is fixed to <outStep>=4. In this mode, any attempt to change <outStep> or other parameters returns an error.
•
The value of <outStep> is stored non-volatile when the ME is powered down with AT^SMSO or reset with AT+CFUN=x,1. Any other parameters changed with AT^SNFO need to be saved with AT^SNFW for use after restart. See also AT^SNFD for details on restoring factory defaults.
•
The values of <outStep> can also be changed with AT^SNFV and AT+CLVL.
•
CAUTION! When you adjust audio parameters avoid exceeding the maximum allowed level. Bear in mind that exposure to excessive levels of noise can cause physical damage to users!